Función SslGetProviderProperty
La función SslGetProviderProperty recupera el valor de una propiedad de proveedor especificada.
Sintaxis
SECURITY_STATUS WINAPI SslGetProviderProperty(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ LPCWSTR pszProperty,
_Out_ PBYTE ppbOutput,
_Out_ DWORD *pcbOutput,
_Inout_ PVOID *ppEnumState,
_In_ DWORD dwFlags
);
Parámetros
-
hSslProvider [in]
-
Identificador del proveedor secure Sockets Layer (SSL) para el que se va a recuperar la propiedad .
-
pszProperty [in]
-
Puntero a una cadena Unicode terminada en null que contiene el nombre de la propiedad que se va a recuperar.
-
ppbOutput [out]
-
Dirección de un búfer que recibe el valor de propiedad.
El autor de la llamada de la función debe liberar este búfer llamando a la función SslFreeBuffer .
-
pcbOutput [out]
-
Tamaño, en bytes, del búfer pbOutput .
-
ppEnumState [in, out]
-
Dirección de un puntero VOID que recibe información de estado de enumeración que se usa en llamadas posteriores a esta función. Esta información solo tiene significado para el proveedor SSL y es opaco para el autor de la llamada. El proveedor SSL usa esta información para determinar qué elemento se encuentra a continuación en la enumeración. Si la variable a la que apunta este parámetro contiene NULL, la enumeración se inicia desde el principio.
El autor de la llamada de la función debe liberar esta memoria llamando a la función SslFreeBuffer .
-
dwFlags [in]
-
Este parámetro se reserva para uso futuro.
Valor devuelto
Si la función se ejecuta correctamente, devuelve cero.
Si se produce un error en la función, devuelve un valor de error distinto de cero.
Entre los códigos de retorno posibles se incluyen, entre otros, los siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
No hay suficiente memoria disponible para asignar los búferes necesarios. |
|
El identificador hSslProvider no es válido. |
|
Uno de los parámetros proporcionados no es válido. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
| Archivo DLL |
|