Método ICertEncodeAltName::GetName (certenc.h)
O método GetName retorna o nome especificado da matriz de nomes alternativos.
Sintaxe
HRESULT GetName(
[in] LONG NameIndex,
[out] BSTR *pstrName
);
Parâmetros
[in] NameIndex
Um índice baseado em zero que especifica o índice da entrada de nome alternativo a ser recuperada.
Para recuperar o OID (identificador de objeto ) de um nome CERT_ALT_NAME_OTHER_NAME, combine o valor do índice com EAN_NAMEOBJECTID (definido como 0x80000000) com uma operação OR bit a bit. Caso contrário, o valor binário será recuperado. Para determinar o tipo de nome, chame o método ICertEncodeAltName::GetNameChoice .
[out] pstrName
Um ponteiro para um BSTR que recebe o nome alternativo. Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString .
Retornar valor
C++
Se o método for bem-sucedido, o método retornará S_OK.Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.
VB
O valor retornado é o nome alternativo no índice especificado. O valor retornado é uma cadeia de caracteres Unicode .Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | certenc.h (inclua Certsrv.h) |
| Biblioteca | Certidl.lib |
| DLL | Certenc.dll |