SslGetServerIdentity function
The SslGetServerIdentity function gets the identity of the server. This function has no associated import library. You must use the LoadLibrary and GetProcAddress functions to dynamically link to Schannel.dll.
Syntax
SECURITY_STATUS WINAPI SslGetServerIdentity( _In_ PBYTE ClientHello, _In_ DWORD ClientHelloSize, _Out_ PBYTE *ServerIdentity, _Out_ PDWORD ServerIdentitySize, _In_ DWORD Flags );
Parameters
- ClientHello [in]
-
The message from the client.
- ClientHelloSize [in]
-
The size of the client message.
- ServerIdentity [out]
-
The pointer inside the message where the server name starts.
- ServerIdentitySize [out]
-
The length of the server name.
- Flags [in]
-
This parameter is reserved and must be zero.
Return value
The status of the call to the function.
| Return code | Description |
|---|---|
|
The function was successful. |
|
One of the parameters ClientHello, ServerIdentity, or ServerIdentitySize is NULL. |
|
The ServerIdentitySize parameter is smaller than the ClientHelloSize parameter. |
Requirements
|
Minimum supported client |
Windows 8 [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2012 [desktop apps only] |
|
Header |
|
|
DLL |
|