Metodo ICEnroll::get_RequestStoreName (xenroll.h)

[Questa proprietà non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La proprietà RequestStoreName imposta o recuperaICEnroll il nome dell'archivio che contiene il certificato fittizio. Questo certificato fittizio, insieme alle chiavi private aggiunte, rimane nell'archivio delle richieste fino a quando un'autorità di certificazione non elabora la richiesta e risponde con un PKCS #7.

Il valore predefinito per questa proprietà è "REQUEST". Se l'impostazione predefinita non deve essere utilizzata, questa proprietà deve essere impostata sull'archivio da utilizzare prima delle chiamate per crearePKCS10 o createFilePKCS10 e di nuovo prima di chiamare per accettarePKCS7 o acceptFilePKCS7.

Questa proprietà è stata definita per la prima volta nell'interfaccia ICEnroll .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_RequestStoreName(
  BSTR *pbstrName
);

Parametri

pbstrName

Valore restituito

nessuno

Osservazioni

In genere, la modifica della proprietà RequestStoreName viene eseguita solo nelle applicazioni avanzate. La modifica di questo valore non è consigliata per la maggior parte delle applicazioni.

La proprietà RequestStoreName influisce sul comportamento dei metodi seguenti:

• acceptPKCS7
• acceptFilePKCS7
• createPKCS10
• createFilePKCS10

La possibilità di impostare questa proprietà è disabilitata quando il controllo di registrazione certificati viene eseguito come controllo con script.

Esempio

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RequestStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName: %ws\n", bstrStoreName );
// free BSTR when done
if ( NULL != bstrStoreName )
    SysFreeString( bstrStoreName );

// set the storename
// bstrNewName is a BSTR that is previously set to a valid store name
hr = pEnroll->put_RequestStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName was set to : %ws\n", bstrNewName );

Requisiti