Compartir a través de

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

  • Artículo

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