Compartilhar via


Função SslGetKeyProperty

A função SslGetKeyProperty recupera o valor de uma propriedade nomeada para um objeto de chave de provedor protocolo SSL .

Sintaxe

SECURITY_STATUS WINAPI SslGetKeyProperty(
  _In_  NCRYPT_KEY_HANDLE hKey,
  _In_  LPCWSTR           pszProperty,
  _Out_ PBYTE             ppbOutput,
  _Out_ DWORD             *pcbOutput,
  _In_  DWORD             dwFlags
);

Parâmetros

hKey [in]

O identificador do provedor SSL.

pszProperty [in]

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da propriedade a ser recuperada. Esse pode ser um dos Identificadores de Propriedade de Armazenamento de Chaves predefinidos ou um identificador de propriedade personalizado.

ppbOutput [out]

Um ponteiro para 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 .

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.

Retornar código/valor Descrição
NTE_INVALID_HANDLE
0x80090026L
Um dos identificadores fornecidos 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