Metodo ICertConfig::GetField (certcli.h)

Articolo
02/23/2024

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

Condividi tramite