Skip to content

Latest commit

 

History

History
98 lines (75 loc) · 2.84 KB

nc-webservices-ws_get_cert_callback.md

File metadata and controls

98 lines (75 loc) · 2.84 KB
Raw
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:webservices.WS_GET_CERT_CALLBACK
WS_GET_CERT_CALLBACK (webservices.h)
Provides a certificate to the security runtime.
WS_GET_CERT_CALLBACK
WS_GET_CERT_CALLBACK callback
WS_GET_CERT_CALLBACK callback function [Web Services for Windows]
webservices/WS_GET_CERT_CALLBACK
wsw.ws_get_cert_callback
wsw\ws_get_cert_callback.htm
wsw
36e787ff-f6bc-4814-be3f-a64f3edc2326
12/05/2018
WS_GET_CERT_CALLBACK, WS_GET_CERT_CALLBACK callback, WS_GET_CERT_CALLBACK callback function [Web Services for Windows], webservices/WS_GET_CERT_CALLBACK, wsw.ws_get_cert_callback
webservices.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Windows
19H1
WS_GET_CERT_CALLBACK
webservices/WS_GET_CERT_CALLBACK
c++
APIRef
kbSyntax
UserDefined
WebServices.h
WS_GET_CERT_CALLBACK

WS_GET_CERT_CALLBACK callback function

-description

Provides a certificate to the security runtime. This callback is specified as part of the WS_CUSTOM_CERT_CREDENTIAL, which in turn may be specified as part of a security binding that requires a certificate credential. The runtime will invoke this callback when the channel (client-side) or the listener (server-side) is opened.

Cert ownership: If this callback returns a success HRESULT, the caller (namely, the security runtime) will take ownership of the returned certificate, and will free it when the containing channel no longer needs it. If this callback returns a failure HRESULT, the caller will NOT take ownership of, or even look at, the value returned in the out parameter 'cert'.

-parameters

-param getCertCallbackState [in]

State that was specified along with this callback in the certificate credential.

-param targetAddress [in, optional]

The target address to whom this certificate is to be presented, in case this certificate credential is specified for a client.

-param viaUri [in, optional]

The via address to whom this certificate is to be presented.

- **cert

The location to return the certificate.

-param error [in, optional]

Specifies where additional error information should be stored if the function fails.

-param cert

The location to return the certificate.

-returns

This callback function does not return a value.