Metodo IX509AttributeClientId::InitializeEncode (certenroll.h)

Articolo
02/23/2024

Il metodo InitializeEncode inizializza l'attributo dalle informazioni sull'utente, sul computer client e sull'applicazione che ha inviato la richiesta di certificato.

Sintassi

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

Parametri

[in] ClientId

Valore di enumerazione RequestClientInfoClientId che identifica il tipo di applicazione che ha creato la richiesta. Gli esempi includono servizi di registrazione automatica, strumenti di richiesta da riga di comando e applicazioni di richiesta personalizzate.

[in, optional] strMachineDnsName

Variabile BSTR che contiene il nome DNS (Domain Name System) del computer in cui è stata creata la richiesta, ad esempio ComputerName.contoso.com. Se non si specifica un nome, il metodo chiama la funzione GetComputerNameEx . Se non è possibile trovare un nome, il metodo ha esito negativo.

[in, optional] strUserSamName

Variabile BSTR che contiene il nome sam (Security Accounts Manager ) per l'utente nel formato NomeDominio\NomeUtente. Se non si specifica un nome, il metodo chiama la funzione GetUserNameEx . Se non è possibile trovare un nome, il metodo ha esito negativo.

[in, optional] strProcessName

Variabile BSTR che contiene il nome dell'applicazione che ha creato la richiesta di certificato. Se non si specifica un nome, il metodo chiama la funzione GetCommandLine e analizza la riga di comando. Se non è possibile trovare un nome, il metodo ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

L'identificatore di oggetto (OID) per questo attributo è XCN_OID_REQUEST_CLIENT_INFO (1.3.6.1.4.1.311.21.20). Per altre informazioni, vedere CERTENROLL_OBJECTID. L'attributo viene creato come struttura ASN.1 (Abstract Syntax Notation One) codificata tramite Distinguished Encoding Rules (DER).

È necessario chiamare InitializeEncode o InitializeDecode prima di poter utilizzare un oggetto IX509AttributeClientId . I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire una struttura ASN.1 codificata da dati non elaborati e il metodo InitializeDecode consente di inizializzare i dati non elaborati da una struttura ASN.1 codificata. È possibile chiamare le proprietà seguenti per recuperare i dati non elaborati:

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h
DLL	CertEnroll.dll

Vedi anche

IX509AttributeClientId

InitializeDecode

Condividi tramite