Metodo IEnumCERTVIEWCOLUMN::Skip (certview.h)

Articolo
03/14/2023

Il metodo Skip ignora un numero specificato di colonne nella sequenza di enumerazione colonna.

Sintassi

HRESULT Skip(
  [in] LONG celt
);

Parametri

[in] celt

Numero di colonne da ignorare. Un valore positivo per il parametro celt causa la sequenza di enumerazione colonna per ignorare l'inoltro nella sequenza di enumerazione. Un valore negativo causa l'enumerazione colonna per ignorare l'indietro nella sequenza di enumerazione.

Valore restituito

VB

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Un valore restituito di E_INVALIDARG indica che un valore negativo nel parametro celt ha causato che l'indice della sequenza di enumerazione della colonna diventi minore di zero.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Al termine di questa funzione, chiamare il metodo IEnumCERTVIEWCOLUMN::Next per fare riferimento alla colonna corrente nella sequenza di enumerazione colonna. Dopo aver effettuato questa seconda chiamata, è possibile ottenere le informazioni nella colonna chiamando uno dei metodi seguenti:

IEnumCERTVIEWCOLUMN::GetName: Recupera il nome non localizzato della colonna.
IEnumCERTVIEWCOLUMN::GetDisplayName: Recupera il nome localizzato della colonna.
IEnumCERTVIEWCOLUMN::GetValue: Recupera i dati nella colonna.
IEnumCERTVIEWCOLUMN::GetType: Recupera il tipo di dati nella colonna.
IEnumCERTVIEWCOLUMN::GetMaxLength: Recupera la lunghezza massima, in byte, della colonna.

La sequenza di enumerazione della colonna gestisce un indice in base zero interno. La chiamata al metodo Skip causa l'aumento o la riduzione dell'indice in base all'impostazione del parametro celt .

Se un valore negativo del parametro celt fa sì che l'indice sia minore di zero, il comportamento delle chiamate successive a Next non è definito.

Se un valore positivo del parametro celt fa sì che l'indice superi l'ultima riga della sequenza di enumerazione, una chiamata successiva al metodo Next avrà esito negativo.

Esempio

HRESULT  hr;
LONG     Index;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// skip the next five columns
hr = pEnumCol->Skip(5);
if (S_OK == hr) 
{
    // get the next column
    hr = pEnumCol->Next(&Index);
    if (S_OK == hr)
    {
        // Use this column as needed.
    }
}

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certview.h (includere Certsrv.h)
Libreria	Certidl.lib
DLL	Certadm.dll