Compartilhar via


Método IObjectId::InitializeFromName (certenroll.h)

O método InitializeFromName inicializa o objeto de um valor de enumeração CERTENROLL_OBJECTID . Esse método está habilitado para a Web.

Sintaxe

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

Parâmetros

[in] Name

Um valor de enumeração CERTENROLL_OBJECTID .

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado Descrição
CERTSRV_E_PROPERTY_EMPTY
Não foi possível encontrar as informações de OID.
CRYPT_E_UNKNOWN_ALGO
O nome do algoritmo não é reconhecido.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
O objeto já está inicializado.

Comentários

Cada valor de CERTENROLL_OBJECTID está associado a um identificador de objeto ASN.1. Por exemplo, o valor XCN_OID_ECDSA_SHA1 está associado a uma cadeia de caracteres que contém 1.2.840.10045.4.1. Esta é a representação decimal pontilhada do identificador de objeto iso(1)member-body(2)us(840)10045 signatures(4)sha1(1).

O método InitializeFromName pesquisa no Registro informações associadas ao identificador de objeto ASN.1. Se as informações forem encontradas, o método preencherá internamente uma estrutura de CRYPT_OID_INFO e a associará ao objeto . O método também usa as informações locais para inicializar, se possível, o nome de exibição do objeto.

Você pode chamar as seguintes propriedades para recuperar informações sobre um objeto IObjectId inicializado:

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]
Plataforma de Destino Windows
Cabeçalho certenroll.h
DLL CertEnroll.dll

Confira também

Friendlyname

IObjectID