Método ICertConfig::GetField (certcli.h)

El método GetField obtiene un campo específico del registro actual de la base de datos de configuración. Este método se definió por primera vez en la interfaz ICertConfig .

Sintaxis

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

Parámetros

[in] strFieldName

Especifica el nombre del campo que se va a devolver. Este parámetro puede ser una de las siguientes cadenas válidas para los nombres de campo (tenga en cuenta que es posible que algunas entidades de certificación no proporcionen datos para cada campo).

Valor	Significado
Autoridad	Nombre de la entidad de certificación (CA) de referencia.
CommonName	Nombre común del servidor.
Config (Configuración).	Haga referencia al nombre de equipo o entidad de certificación.
País	País o región.
Descripción	Comentario descriptivo sobre el servidor (reemplaza a "Comentario" obsoleto).
ExchangeCertificate	Nombre del archivo que contiene el certificado de intercambio (solo se aplica a Certificate Services 1.0).
Marcas	Cadena que representa la ubicación donde se encontró la información de ca. Para obtener más información, vea la sección Comentarios.
Localidad	Ciudad o ciudad.
Organización	Organización.
OrgUnit	Unidad organizativa.
SanitizedName	Nombre de entidad de certificación saneado según las reglas descritas en GetConfig.
SanitizedShortName	Nombre de entidad de certificación saneado y abreviado según las reglas descritas en GetConfig.
Servidor	Nombre de equipo de referencia.
nombreCorto	SanitizedShortName, pero con las secuencias "!xxx", como se describe en GetConfig, se traduce de nuevo en el texto original.
SignatureCertificate	Nombre del archivo que contiene el certificado de entidad de certificación (también conocido como certificado de firma de ca); puede ser o no un certificado raíz.
State	Estado o provincia.
WebEnrollmentServers	Matriz de direcciones URL de servicio web de inscripción de certificados para una configuración de CA específica en Active Directory. Windows Vista y Windows Storage Server 2003: Este campo no se admite.

[out, retval] pstrOut

Puntero a un BSTR que recibe los datos del campo. Cuando haya terminado de usar BSTR, pbstrOut gratis llamando a la función SysFreeString .

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es una cadena que representa los datos del campo.

Comentarios

Este método devuelve los datos de campo del campo especificado.

Al especificar "Flags" en el parámetro strFieldName , los datos recuperados para el campo flags son una cadena que se puede convertir en un entero mediante la función de biblioteca de C _wtoi. El entero resultante representa un campo de bits que se puede examinar para determinar si se establecen las marcas CAIF_DSENTRY y CAIF_SHAREDFOLDERENTRY. Si se establece CAIF_DSENTRY (0x00000001), la información de la ENTIDAD de certificación se contenía en servicios de directorio. Si se establece CAIF_SHAREDFOLDERENTRY (0x00000002), la información de la ENTIDAD de certificación se contenía en la carpeta compartida. Tenga en cuenta que se puede establecer una o ambas marcas.

Ejemplos

    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);

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certcli.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certcli.dll

Consulte también

CCertConfig

ICertConfig