Share via

Método IX509AttributeClientId::InitializeEncode (certenroll.h)

  • Artigo

O método InitializeEncode inicializa o atributo de informações sobre o usuário, o computador cliente e o aplicativo que enviou a solicitação de certificado.

Sintaxe

HRESULT InitializeEncode(
  [in]           RequestClientInfoClientId ClientId,
  [in, optional] BSTR                      strMachineDnsName,
  [in, optional] BSTR                      strUserSamName,
  [in, optional] BSTR                      strProcessName
);

Parâmetros

[in] ClientId

Um valor de enumeração RequestClientInfoClientId que identifica o tipo de aplicativo que criou a solicitação. Os exemplos incluem serviços de registro automático, ferramentas de solicitação de linha de comando e aplicativos de solicitação personalizados.

[in, optional] strMachineDnsName

Uma variável BSTR que contém o nome DNS (Sistema de Nomes de Domínio) do computador no qual a solicitação foi criada, por exemplo ComputerName.contoso.com. Se você não fornecer um nome, o método chamará a função GetComputerNameEx . Se um nome não puder ser encontrado, o método falhará.

[in, optional] strUserSamName

Uma variável BSTR que contém o nome SAM ( Gerenciador de Contas de Segurança ) para o usuário no formulário DomainName\UserName. Se você não fornecer um nome, o método chamará a função GetUserNameEx . Se um nome não puder ser encontrado, o método falhará.

[in, optional] strProcessName

Uma variável BSTR que contém o nome do aplicativo que criou a solicitação de certificado. Se você não fornecer um nome, o método chamará a função GetCommandLine e analisará a linha de comando. Se um nome não puder ser encontrado, o método falhará.

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. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

O OID ( identificador de objeto ) para esse atributo é XCN_OID_REQUEST_CLIENT_INFO (1.3.6.1.4.1.311.21.20). Para obter mais informações, consulte CERTENROLL_OBJECTID. O atributo é criado como uma estrutura ASN.1 (Abstract Syntax Notation One) codificada usando Distinguished Encoding Rules (DER).

Você deve chamar InitializeEncode ou InitializeDecode antes de usar um objeto IX509AttributeClientId . Os dois métodos se complementam. O método InitializeEncode permite que você construa uma estrutura ASN.1 codificada com base em dados brutos e o método InitializeDecode permite inicializar dados brutos de uma estrutura ASN.1 codificada. Você pode chamar as seguintes propriedades para recuperar os dados brutos:

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

IX509AttributeClientId

InitializeDecode