Método IEnumCERTVIEWEXTENSION::GetName (certview.h)

Artigo
02/23/2024

O método GetName recupera o nome da extensão atual na sequência de enumeração de extensão.

O nome da extensão retornada é uma cadeia de caracteres OID ( identificador de objeto ), como em L"2.5.29.31".

Sintaxe

HRESULT GetName(
  [out] BSTR *pstrOut
);

Parâmetros

[out] pstrOut

Um ponteiro para um valor do tipo BSTR que contém o nome da extensão.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e tat o parâmetro pstrOut será definido como o nome da extensão.

Para usar esse método, crie uma variável do tipo BSTR , defina a variável igual a NULL e passe o endereço dessa variável como pstrOut. Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString .

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 é um String que contém o nome da extensão.

Comentários

Essa função é usada para recuperar o nome da extensão referenciada atualmente pela sequência de enumeração de extensão.

Se a sequência de enumeração de extensão não estiver fazendo referência a uma extensão válida, GetName falhará. Use um dos seguintes métodos para navegar pela enumeração :

IEnumCERTVIEWEXTENSION::Reset: move para a próxima extensão na sequência de enumeração.
IEnumCERTVIEWEXTENSION::Next: move para a próxima extensão na sequência de enumeração.
IEnumCERTVIEWEXTENSION::Skip: ignora um número especificado de extensões.

Exemplos

BSTR  bstrExtName = NULL;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetName(&bstrExtName);
if (S_OK == hr)
    printf("Extension name is: %ws\n", bstrExtName);
else
    printf("GetName failed: %x\n", hr);

// free memory when done
if (NULL != bstrExtName)
    SysFreeString(bstrExtName);

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	certview.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certadm.dll