nc-ntsecpkg-spexchangemetadatafn.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NC:ntsecpkg.SpExchangeMetaDataFn	SpExchangeMetaDataFn (ntsecpkg.h)	Sends metadata to a security support provider.	ISC_REQ_ALLOCATE_MEMORY ISC_REQ_CONNECTION ISC_REQ_DATAGRAM ISC_REQ_DELEGATE ISC_REQ_EXTENDED_ERROR ISC_REQ_INTEGRITY ISC_REQ_MUTUAL_AUTH ISC_REQ_PROMPT_FOR_CREDS ISC_REQ_REPLAY_DETECT ISC_REQ_SEQUENCE_DETECT ISC_REQ_STREAM ISC_REQ_USE_DCE_STYLE ISC_REQ_USE_SESSION_KEY ISC_REQ_USE_SUPPLIED_CREDS SpExchangeMetaDataFn SpExchangeMetaDataFn callback SpExchangeMetaDataFn callback function [Security] ntsecpkg/SpExchangeMetaDataFn security.spexchangemetadatafn	security\spexchangemetadatafn.htm	security	35ef9276-1d61-44f3-912c-cf07dfcf7984	12/05/2018	ISC_REQ_ALLOCATE_MEMORY, ISC_REQ_CONNECTION, ISC_REQ_DATAGRAM, ISC_REQ_DELEGATE, ISC_REQ_EXTENDED_ERROR, ISC_REQ_INTEGRITY, ISC_REQ_MUTUAL_AUTH, ISC_REQ_PROMPT_FOR_CREDS, ISC_REQ_REPLAY_DETECT, ISC_REQ_SEQUENCE_DETECT, ISC_REQ_STREAM, ISC_REQ_USE_DCE_STYLE, ISC_REQ_USE_SESSION_KEY, ISC_REQ_USE_SUPPLIED_CREDS, SpExchangeMetaDataFn, SpExchangeMetaDataFn callback, SpExchangeMetaDataFn callback function [Security], ntsecpkg/SpExchangeMetaDataFn, security.spexchangemetadatafn	ntsecpkg.h		Windows	Windows 7 [desktop apps only]	Windows Server 2008 R2 [desktop apps only]													Windows			19H1	SpExchangeMetaDataFn ntsecpkg/SpExchangeMetaDataFn	c++	APIRef kbSyntax	UserDefined	Ntsecpkg.h	SpExchangeMetaDataFn

SpExchangeMetaDataFn callback function

-description

Sends metadata to a security support provider. The metadata sent by this function is obtained by a previous call to the SpQueryMetaDataFn function.

-parameters

-param CredentialHandle [in]

A handle to the credentials to use for the security context. If the ContextHandle parameter points to NULL on input, this function uses the value of this parameter to create a security context.

The value of this parameter cannot be NULL if the ContextHandle parameter points to NULL on input.

-param TargetName [in, optional]

A pointer to a UNICODE_STRING that contains the name of the target of the context.

-param ContextRequirements [in]

Flags that indicate the context attributes required by the client.

The following are valid values. Values can be combined by using a logical OR operation.

Value	Meaning
ISC_REQ_DELEGATE	The server is allowed to impersonate the client.
ISC_REQ_MUTUAL_AUTH	Both the client and the server are required to prove their identity.
ISC_REQ_REPLAY_DETECT	The security context will support the detection of replayed packets.
ISC_REQ_SEQUENCE_DETECT	The security context will support the detection of out-of-order messages.
ISC_REQ_USE_SESSION_KEY	A new session key must be negotiated.
ISC_REQ_PROMPT_FOR_CREDS	If the client is an interactive user, the package must, if possible, prompt the user for the appropriate credentials.
ISC_REQ_USE_SUPPLIED_CREDS	The input buffer contains package-specific credential information which should be used to authenticate the connection.
ISC_REQ_ALLOCATE_MEMORY	The package must allocate memory. The caller must eventually call the FreeContextBuffer function to free memory allocated by the package.
ISC_REQ_USE_DCE_STYLE	The caller expects a three-leg mutual authentication transaction.
ISC_REQ_DATAGRAM	A datagram-type communications channel should be used. For more information, see Datagram Contexts.
ISC_REQ_CONNECTION	A connection-type communications channel should be used. For more information see Connection-Oriented Contexts.
ISC_REQ_EXTENDED_ERROR	If the context fails, generate an error reply message to send back to the client.
ISC_REQ_STREAM	A stream-type communications channel should be used. For more information, see Stream Contexts.
ISC_REQ_INTEGRITY	Buffer integrity is verified; however, replayed and out-of-sequence messages will not be detected.

-param MetaDataLength [in]

The size, in characters, of the MetaData buffer.

-param MetaData [in]

The metadata to send.

-param ContextHandle [in, out]

A handle to the security handle to use. If this parameter points to NULL on input, this function allocates and initializes a security context by using the values of the CredentialHandle and TargetName parameters.

If this parameter points to NULL on input, the CredentialHandle cannot be NULL.

-returns

If the function succeeds, return STATUS_SUCCESS, or an informational status code.

If the function fails, return an NTSTATUS error code that indicates the reason it failed. For more information, see Remarks.

-remarks

A pointer to the SpExchangeMetaDataFn function is available in the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize function.