Método ICertView::SetResultColumn (certview.h)

Artículo
03/14/2023

El método SetResultColumn especifica una columna para el conjunto de resultados de una vista personalizada de la base de datos de Servicios de certificados.

Sintaxis

HRESULT SetResultColumn(
  [in] LONG ColumnIndex
);

Parámetros

[in] ColumnIndex

Índice de base cero de una columna que se va a incluir en el conjunto de resultados.

Valor devuelto

VB

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.

Comentarios

Antes de llamar al método SetResultColumn , se debe llamar al método SetResultColumnCount para especificar cuántas columnas estarán en el conjunto de resultados. Las llamadas al método SetResultColumn producirán un error en las condiciones siguientes:

No se ha especificado el número de columnas.
Se llama a SetResultColumn más veces que el número de columnas especificadas por la llamada a SetResultColumnCount.
SetResultColumnCount especificó un conjunto predefinido de columnas. Este método especifica un conjunto predefinido de columnas cuando su parámetro cResultColumnCount es uno de los siguientes valores:
- CV_COLUMN_LOG_DEFAULT
- CV_COLUMN_LOG_FAILED_DEFAULT
- CV_COLUMN_QUEUE_DEFAULT

Una vez especificada una columna, se puede usar una llamada opcional al método SetRestriction para especificar restricciones de ordenación y calificación para la columna.

Se debe llamar al método SetResultColumn para cada columna necesaria en el conjunto de resultados. Cuando se complete correctamente estas llamadas, las columnas especificadas en cada llamada se incluirán en el conjunto de resultados cuando se llame al método OpenView .

Ejemplos

    HRESULT    hr;
    LONG       nCount;
    LONG       i;

    // Determine the number of columns in the entire database.
    // pCertView is a pointer to ICertView.
    hr = pCertView->GetColumnCount(FALSE, &nCount);
    if (FAILED(hr))
    {
        printf("Failed GetColumnCount - %x\n", hr);
        goto error;
    }
    hr = pCertView->SetResultColumnCount( nCount );
    if (FAILED(hr))
    {
        printf("Failed SetResultColumnCount - %x\n", hr);
        goto error;
    }
    // Place each column in the view.
    for (i = 0; i < nCount; i++)
    {
        hr = pCertView->SetResultColumn(i);
        if (FAILED(hr))
        {
            printf("Failed SetResultColumn (%d) - %x\n", i, hr );
            goto error;
        }
    }
    // Call ICertView::OpenView, and so on.
    // ...

error:
	{
		 // Clean up resources, and so on.
	}

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	certview.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll