Metodo IX509CertificateRequest::GetInnerRequest (certenroll.h)

Articolo
02/26/2024

Il metodo GetInnerRequest recupera un oggetto richiesta annidato.

Sintassi

HRESULT GetInnerRequest(
  [in]  InnerRequestLevel       Level,
  [out] IX509CertificateRequest **ppValue
);

Parametri

[in] Level

Valore di un'enumerazione InnerRequestLevel che specifica il livello di avvolgimento dei dati da recuperare. È possibile usare il valore LevelNext per scorrere i livelli annidati o il valore LevelInnermost per recuperare l'oggetto richiesta più annidato. Non è possibile specificare LevelNext per una richiesta PKCS #10.

[out] ppValue

Indirizzo di una variabile che riceve un puntatore a un'interfaccia IX509CertificateRequest che contiene la richiesta annidata. Chiamare la proprietà Type per determinare se l'oggetto richiesta interna è una richiesta PKCS #10 o cmC. Chiamare quindi QueryInterface per recuperare il puntatore appropriato.

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. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito	Descrizione
CERTSRV_E_PROPERTY_EMPTY	È stato specificato un valore della richiesta LevelNext PKCS #10.

Commenti

Un oggetto richiesta di primo livello può essere una richiesta PKCS #10, PKCS #7 o CMC. Le regole seguenti si applicano agli oggetti richiesta interni:

Una richiesta PKCS #10 non può contenere un oggetto richiesta interno.
Una richiesta PKCS #7 può contenere solo un oggetto richiesta interna PKCS #10.
Una richiesta CMC può contenere un oggetto di richiesta interna PKCS o PKCS #10. Per una richiesta CMC che contiene una richiesta CMC interna, non esiste alcun limite teorico al numero di livelli annidati che possono esistere prima che venga raggiunta la richiesta PKCS #10 finale. Vale a dire, una richiesta CMC di primo livello può contenere una richiesta CMC interna che contiene anche una richiesta CMC interna e così via.

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