Metodo ICertConfig::GetField (certcli.h)

  • Articolo

Il metodo GetField ottiene un campo specifico dal record corrente del database di configurazione. Questo metodo è stato definito per la prima volta nell'interfaccia ICertConfig .

Sintassi

HRESULT GetField(
  [in]          const BSTR strFieldName,
  [out, retval] BSTR       *pstrOut
);

Parametri

[in] strFieldName

Specifica il nome del campo da restituire. Questo parametro può essere una delle stringhe valide seguenti per i nomi dei campi. Si noti che alcune autorità di certificazione potrebbero non fornire dati per ogni campo.

Valore Significato
Authority
 Nome dell'autorità di certificazione (CA) di riferimento.
CommonName
 Nome comune del server.
File di configurazione
 Nome computer\CA di riferimento.
Paese
 Paese/area geografica.
Descrizione
 Commento descrittivo sul server (sostituisce "Commento" obsoleto).
Exchangecertificate
 Nome del file che contiene il certificato di scambio (si applica solo a Servizi certificati 1.0).
Flag
 Stringa che rappresenta la posizione in cui sono state trovate le informazioni sulla CA. Per altre informazioni, vedere la sezione Osservazioni.
Località
 Città o città.
Organizzazione
 Organizzazione.
OrgUnit
 Unità organizzativa.
SanitizedName
 Nome CA che viene sanificato in base alle regole descritte in GetConfig.
SanitizedShortName
 Nome CA che viene sanificato e abbreviato in base alle regole descritte in GetConfig.
Server
 Nome computer di riferimento.
ShortName
 SanitizedShortName, ma con le sequenze '!xxx', come descritto in GetConfig, è stato convertito nuovamente nel testo originale.
SignatureCertificate
 Nome del file che contiene il certificato della CA (noto anche come certificato di firma DELLA CA); questo può essere o meno un certificato radice.
State
 Stato o provincia.
WebEnrollmentServers
 Matrice di URL del servizio Web di registrazione certificati per una configurazione CA specifica in Active Directory.

Windows Vista e Windows Storage Server 2003: Questo campo non è supportato.

[out, retval] pstrOut

Puntatore a un BSTR che riceve i dati dal campo. Al termine dell'uso di BSTR, free pbstrOut chiamando la funzione SysFreeString .

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

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

VB

Il valore restituito è una stringa che rappresenta i dati per il campo.

Commenti

Questo metodo restituisce i dati del campo per il campo specificato.

Quando si specifica "Flags" nel parametro strFieldName , i dati recuperati per il campo flags sono una stringa che può essere convertita in un numero intero tramite la funzione della libreria C _wtoi. L'intero risultante rappresenta un campo di bit che può essere esaminato per determinare se i flag CAIF_DSENTRY e CAIF_SHAREDFOLDERENTRY sono impostati. Se CAIF_DSENTRY (0x00000001) è impostata, le informazioni per l'autorità di certificazione sono contenute in Servizi directory. Se CAIF_SHAREDFOLDERENTRY (0x00000002) è impostato, le informazioni per la CA erano contenute nella cartella condivisa. Si noti che è possibile impostare uno o entrambi questi flag.

Esempio

    BSTR  bstrFieldName = NULL;
    BSTR  bstrFieldValue = NULL;
    HRESULT    hr;

    // Specify the field to retrieve, for example, "CommonName".
    bstrFieldName = SysAllocString(L"<FIELDNAMEHERE>");
    if (NULL == bstrFieldName)
    {
        printf("Memory allocation failed for bstrFieldName.\n");
        goto error;
    }

    // pConfig is a previously instantiated ICertConfig object.
    hr = pConfig->GetField(bstrFieldName, &bstrFieldValue);
    if (FAILED(hr))
    {
        printf("Failed GetField - [%x]\n", hr);
        goto error;
    }
    else
        printf("GetField value for %ws is: %ws\n", 
            bstrFieldName, bstrFieldValue );

error:

    if (bstrFieldName)
        SysFreeString(bstrFieldName);

    if (bstrFieldValue)
        SysFreeString(bstrFieldValue);

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certcli.h (include Certsrv.h)
Libreria Certidl.lib
DLL Certcli.dll

Vedi anche

CCertConfig

ICertConfig