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

Artigo
08/22/2023

O método SetResultColumnCount especifica o número máximo de colunas para o conjunto de resultados de uma exibição personalizada do banco de dados dos Serviços de Certificados.

Sintaxe

HRESULT SetResultColumnCount(
  [in] LONG cResultColumn
);

Parâmetros

[in] cResultColumn

Especifica o número máximo de colunas no conjunto de resultados. Esse parâmetro pode ser definido como um número positivo ou como zero se você estiver interessado apenas em contar as linhas do banco de dados dos Serviços de Certificados ou como uma das constantes a seguir.

Valor	Significado
CV_COLUMN_LOG_DEFAULT	O número de colunas no conjunto de resultados será o número de colunas no conjunto de resultados padrão dos Serviços de Certificados para solicitações que foram resolvidas. Uma solicitação será resolvida se tiver resultado em um certificado emitido ou em uma solicitação com falha; certificados revogados são considerados resolvidos.
CV_COLUMN_LOG_FAILED_DEFAULT	O número de colunas no conjunto de resultados será o número de colunas no conjunto de resultados padrão dos Serviços de Certificados para solicitações que falharam.
CV_COLUMN_QUEUE_DEFAULT	O número de colunas no conjunto de resultados será o número de colunas no conjunto de resultados padrão dos Serviços de Certificados para solicitações que não foram resolvidas.

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 SetResultColumnCount , é necessário estabelecer uma conexão com um servidor dos Serviços de Certificados chamando primeiro o método OpenConnection . Depois que a conexão for estabelecida, esse método poderá ser chamado uma vez e apenas uma vez para especificar o número máximo de colunas no conjunto de resultados.

Se o parâmetro cResultColumn for definido como um número positivo (não uma das constantes predefinidas), o método SetResultColumn deverá ser chamado para especificar quais colunas incluir no conjunto de resultados. Observe que SetResultColumn falhará se for chamado mais do que o número de colunas especificado por SetResultColumnCount.

Exemplos

HRESULT    hr;
// Specify the result set for logged requests.
// pCertView is pointer to ICertView (which has an Open Connection)
hr = pCertView->SetResultColumnCount(CV_COLUMN_LOG_DEFAULT);
if (S_OK != hr)
    printf("Failed ICertView::SetResultColumnCount - %x\n", hr);
else
{
    // Retrieve data rows by means of ICertView::OpenView.
    // ...
}

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