Função SslGetProviderProperty
A função SslGetProviderProperty recupera o valor de uma propriedade de provedor especificada.
Sintaxe
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]
-
O identificador do provedor de protocolo SSL para o qual recuperar a propriedade.
-
pszProperty [in]
-
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da propriedade a ser recuperada.
-
ppbOutput [out]
-
O endereço de um buffer que recebe o valor da propriedade.
O chamador da função deve liberar esse buffer chamando a função SslFreeBuffer .
-
pcbOutput [out]
-
O tamanho, em bytes, do buffer pbOutput .
-
ppEnumState [in, out]
-
O endereço de um ponteiro VOID que recebe informações de estado de enumeração usadas em chamadas subsequentes para essa função. Essas informações só têm significado para o provedor SSL e são opacas para o chamador. O provedor SSL usa essas informações para determinar qual item é o próximo na enumeração. Se a variável apontada por esse parâmetro contiver NULL, a enumeração será iniciada desde o início.
O chamador da função deve liberar essa memória chamando a função SslFreeBuffer .
-
dwFlags [in]
-
Esse parâmetro é reservado para uso futuro.
Valor retornado
Se a função for bem-sucedida, ela retornará zero.
Se a função falhar, ela retornará um valor de erro diferente de zero.
Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.
| Código/valor de retorno | Descrição |
|---|---|
|
Não há memória suficiente disponível para alocar os buffers necessários. |
|
O identificador hSslProvider não é válido. |
|
Um dos parâmetros fornecidos não é válido. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| DLL |
|