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
NTE_NO_MEMORY 0x8009000EL	Não há memória suficiente disponível para alocar os buffers necessários.
NTE_INVALID_HANDLE 0x80090026L	O identificador hSslProvider não é válido.
NTE_INVALID_PARAMETER 0x80090027L	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	Sslprovider.h
DLL	Ncrypt.dll