IEnumCERTVIEWCOLUMN：：Next 方法 (certview.h)

發行項
03/14/2023

Next方法會移至資料行列舉序列中的下一個資料行。

語法

HRESULT Next(
  [out] LONG *pIndex
);

參數

[out] pIndex

變數的指標，其中包含資料行列舉序列所參考之下一個資料行的索引值。如果沒有其他要列舉的資料行，此變數會設定為 –1。如果 pIndex 為 Null，這個方法將會失敗。

傳回值

C++

如果方法成功，方法會傳回S_OK，而資料行列舉序列中的下一個資料行現在正被參考。如果沒有其他要列舉的資料行，方法會傳回S_FALSE，而 pIndex 參數會設定為 –1 的值。

如果方法失敗，它會傳回 HRESULT 值，指出錯誤。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

VB

傳回值是資料行列舉序列現在所參考之資料行的索引值。如果沒有其他要列舉的資料行，則傳回值為 –1。

備註

成功完成此方法之後，您可以呼叫下列其中一種方法來取得資料行中的資訊：

IEnumCERTVIEWCOLUMN：：GetName：擷取資料行的非本機名稱。
IEnumCERTVIEWCOLUMN：：GetDisplayName：擷取資料行的當地語系化名稱。
IEnumCERTVIEWCOLUMN：：GetValue：擷取資料行中的資料。
IEnumCERTVIEWCOLUMN：：GetType：擷取資料行中的資料類型。
IEnumCERTVIEWCOLUMN：：GetMaxLength：擷取資料行的最大長度，以位元組為單位。

範例

LONG       nLength;
LONG       nType;
LONG       bIsindexed;
LONG       Index;

HRESULT    hr;

BSTR       bstrColName = NULL;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// examine each column
while (S_OK == pEnumCol->Next(&Index))
{
    // determine database length
    hr = pEnumCol->GetMaxLength(&nLength);
    if (FAILED(hr))
    {
        printf("Failed GetMaxLength %x\n", hr);
        goto error;
    }

    // determine data type
    hr = pEnumCol->GetType(&nType);
    if (FAILED(hr))
    {
        printf("Failed GetType %x\n", hr);
        goto error;
    }

    // determine whether column is indexed
    hr = pEnumCol->IsIndexed(&bIsindexed);
    if (FAILED(hr))
    {
        printf("Failed IsIndexed %x\n", hr);
        goto error;
    }

    // retrieve column name
    hr = pEnumCol->GetName(&bstrColName);
    if (FAILED(hr))
    {
        printf("Failed GetName %x\n", hr);
        goto error;
    }

    // print this column's info on one line
    // print name and length
    printf("Column %ws has max length %d",
            bstrColName,
            nLength); 

    // print data type
    switch (nType)
    {
        case PROPTYPE_BINARY:
            printf(" Type is Binary");
            break;
        case PROPTYPE_DATE:
            printf(" Type is Date+Time");
            break;
        case PROPTYPE_LONG:
            printf(" Type is Signed long");
            break;
        case PROPTYPE_STRING:
            printf(" Type is Unicode String");
            break;
        default:
            printf(" Type is unknown");
            break;
    }

    // print index status
    printf(bIsindexed ? " Indexed" : " Not indexed");
    // print new line marker
    printf("\n");

}

error:

// done processing, clear resources
if (NULL != bstrColName)
    SysFreeString(bstrColName);

規格需求


最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	certview.h (包含 Certsrv.h)
程式庫	Certidl.lib
Dll	Certadm.dll