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

Artigo
02/23/2024

O método SetResultColumn especifica uma coluna para o conjunto de resultados de uma exibição personalizada do banco de dados dos Serviços de Certificados.

Sintaxe

HRESULT SetResultColumn(
  [in] LONG ColumnIndex
);

Parâmetros

[in] ColumnIndex

Um índice baseado em zero de uma coluna a ser incluído no conjunto de resultados.

Retornar valor

VB

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Antes de chamar o método SetResultColumn , o método SetResultColumnCount deve ser chamado para especificar quantas colunas estarão no conjunto de resultados. As chamadas para o método SetResultColumn falharão nas seguintes condições:

O número de colunas não foi especificado.
SetResultColumn é chamado mais vezes do que o número de colunas especificadas pela chamada para SetResultColumnCount.
SetResultColumnCount especificou um conjunto predefinido de colunas. Esse método especifica um conjunto predefinido de colunas quando seu parâmetro cResultColumnCount é um dos seguintes valores:
- CV_COLUMN_LOG_DEFAULT
- CV_COLUMN_LOG_FAILED_DEFAULT
- CV_COLUMN_QUEUE_DEFAULT

Depois que uma coluna é especificada, uma chamada opcional para o método SetRestriction pode ser usada para especificar restrições de classificação e qualificação para a coluna.

O método SetResultColumn deve ser chamado para cada coluna necessária no conjunto de resultados. Após a conclusão bem-sucedida dessas chamadas, as colunas especificadas em cada chamada serão incluídas no conjunto de resultados quando o método OpenView for chamado.

Exemplos

    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	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certview.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certadm.dll