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 | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NS:drt.drt_security_provider_tag |
DRT_SECURITY_PROVIDER (drt.h) |
DRT_SECURITY_PROVIDER structure defines the DRT interface that must be implemented by a security provider. |
|
p2p\drt_security_provider.htm |
p2p |
1eedfff3-d561-462e-bad0-45e7bc46fb1a |
12/05/2018 |
*PDRT_SECURITY_PROVIDER, DRT_SECURITY_PROVIDER, DRT_SECURITY_PROVIDER structure [Peer Networking], PDRT_SECURITY_PROVIDER, PDRT_SECURITY_PROVIDER structure pointer [Peer Networking], drt/DRT_SECURITY_PROVIDER, drt/PDRT_SECURITY_PROVIDER, p2p.drt_security_provider |
drt.h |
Windows |
Windows 7 Professional [desktop apps only] |
Windows Server 2008 R2 [desktop apps only] |
Windows |
DRT_SECURITY_PROVIDER, *PDRT_SECURITY_PROVIDER |
19H1 |
|
|
|
|
|
|
The DRT_SECURITY_PROVIDER structure defines the DRT interface that must be implemented by a security provider.
This member is specified by the application when passing the DRT_SECURITY_PROVIDER structure to the DrtOpen function.
The DRT treats it as an opaque pointer, and passes it as the first parameter to the functions referenced by this structure. An application will use this as a pointer to the security provider state or to the object that implements the security provider functionality.
Increments the count of references for the Security Provider with a set of DRTs.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Decrements the count of references for the Security Provider with a set of DRTs.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Called to register a key with the Security Provider.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Pointer to the DRT_REGISTRATION structure created by an application and passed to the DrtRegisterKey function.
Pointer to the context data created by an application and passed to the DrtRegisterKey function.
Called to deregister a key with the Security Provider.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Pointer to the key to which the payload is registered.
Pointer to the context data created by the application and passed to DrtRegisterKey.
Called when an Authority message is received on the wire. It is responsible for validating the data received, and for unpacking the service addresses, revoked flag, and nonce from the Secured Address Payload.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Pointer to the payload received on the wire that contains the service addresses, revoked flag, nonce, and any other data required by the security provider.
Pointer to the cert chain received in the authority message.
Pointer to the classifier received in the authority message
Pointer to the nonce that was sent in the original Inquire or Lookup message. This value must be compared to the value embedded in the Secured Address Payload to ensure they are the same. This value is fixed at 16 bytes.
Pointer to the application data payload received in the Authority message. After validation, the original data (after decryption, removal of signature, and so on.) is output as pPayload.
Pointer to the byte array that represents the protocol major version. This is packed in every DRT packet to identify the version of the security provider in use when a single DRT instance is supporting multiple Security Providers.
Pointer to the byte array that represents the protocol minor version. This is packed in every DRT packet to identify the version of the security provider in use when a single DRT instance is supporting multiple Security Providers.
Pointer to the key to which the payload is registered.
Pointer to the original payload specified by the remote application. pPayload.pb is allocated by the security provider.
Pointer to a pointer to the number of service addresses embedded in the secured address payload.
Pointer to a pointer to the service addresses that are embedded in the Secured Address Payload. pAddresses is allocated by the security provider.
Any DRT flags currently defined only to be the revoked or deleted flag that need to be unpacked for the local DRT instance processing.
Called when an Authority message is about to be sent on the wire. It is responsible for securing the data before it is sent, and for packing the service addresses, revoked flag, nonce, and other application data into the Secured Address Payload.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Contains the context passed into DrtRegisterKey when the key was registered.
Pointer to the byte array that represents the protocol major version.
Pointer to the byte array that represents the protocol minor version.
Any DRT specific flags, currently defined only to be the revoked or deleted flag that need to be packed, secured and sent to another instance for processing.
Pointer to the key to which this payload is registered.
Pointer to the payload specified by the application when calling DrtRegisterKey.
Pointer to the service addresses that are placed in the Secured Address Payload.
Pointer to the nonce that was sent in the original Inquire or Lookup message. This value is fixed at 16 bytes.
Pointer to the payload to send on the wire which contains the service addresses, revoked flag, nonce, and other data required by the security provider. pSecuredAddressPayload.pb is allocated by the security provider.
Pointer to the classifier to send in the Authority message. pClassifier.pb is allocated by the security provider.
Pointer to the application data payload received in the Authority message. After validation, the original data (after decryption, removal of signature, and so on.) is output as pPayload. pSecuredPayload.pb is allocated by the security provider.
Pointer to the cert chain to send in the Authority message. pCertChain.pb is allocated by the security provider.
Called to release resources previously allocated for a security provider function.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Specifies what data to free.
Called when the DRT sends a message containing data that must be encrypted. This function is only called when the DRT is operating in the DRT_SECURE_CONFIDENTIALPAYLOAD security mode defined by DRT_SECURITY_MODE.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Contains the credential of the peer that will receive the protected message.
Contains the length of the pDataBuffers and pEncryptedBuffers.
Contains the unencrypted buffer.
Contains the encrypted content upon completion of the function.
Contains the encrypted session key that can be decrypted by the recipient of the message and used to decrypted the protected fields.
Called when the DRT receives a message containing encrypted data. This function is only called when the DRT is operating in the DRT_SECURE_CONFIDENTIALPAYLOAD security mode defined by DRT_SECURITY_MODE.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Contains the encrypted session key that can be decrypted by the recipient of the message and used to decrypt the protected fields.
Contains the context passed into DrtRegisterKey when the key was registered.
Contains the size of pData buffer.
Contains the decrypted data upon completion of the function.
Called when the DRT must provide a credential used to authorize the local node. This function is only called when the DRT is operating in the DRT_SECURE_MEMBERSHIP and DRT_SECURE_CONFIDENTIALPAYLOAD security modes defined by DRT_SECURITY_MODE.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Contains the serialized credential upon completion of the function.
Called when the DRT must validate a credential provided by a peer node.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Contains the serialized credential provided by the peer node.
Called when the DRT must sign a data blob for inclusion in a DRT protocol message. This function is only called when the DRT is operating in the DRT_SECURE_MEMBERSHIP and DRT_SECURE_CONFIDENTIALPAYLOAD security modes defined by DRT_SECURITY_MODE.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Contains the size of the pDataBuffers buffer.
Contains the data to be signed.
Upon completion of this function, contains an index that can be used to select from multiple credentials for use in calculating the signature.
Upon completion of this function, contains the signature data.
Called when the DRT must verify a signature calculated over a block of data included in a DRT message. This function is only called when the DRT is operating in the DRT_SECURE_MEMBERSHIP and DRT_SECURE_CONFIDENTIALPAYLOAD security modes defined by DRT_SECURITY_MODE.
Pointer to the value held by the pvContext member of DRT_SECURITY_PROVIDER.
Contains the size of the pDataBuffers buffer.
Contains the data over which the signature was calculated.
Contains the credentials of the remote node used to calculate the signature.
Contains an index that may be used to select from multiple credentials provided in pRemoteCredentials.
Contains the signature to be verified.