IDirectorySearch：：GetNextColumnName 方法 (iads.h)

IDirectorySearch：：GetNextColumnName方法會取得包含資料的搜尋結果中下一個資料行的名稱。

語法

HRESULT GetNextColumnName(
  [in]  ADS_SEARCH_HANDLE hSearchHandle,
  [out] LPWSTR            *ppszColumnName
);

參數

[in] hSearchHandle

提供搜尋內容的控制碼。

[out] ppszColumnName

提供包含所要求資料行名稱的方法配置字串指標位址。 如果 為 Null，則沒有後續的資料列包含資料。

傳回值

這個方法會傳回標準傳回值，以及下列專案：

如需其他傳回值，請參閱 ADSI 錯誤碼。

備註

這個方法會配置足夠的記憶體給資料行名稱，但呼叫端必須呼叫 FreeADsMem 協助程式函式，以在不再需要記憶體時釋放此記憶體。

範例

LPWSTR pszColumn;
m_pSearch->GetFirstRow( hSearch );
printf("Column names are: ");
while( m_pSearch->GetNextColumnName( hSearch, &pszColumn ) != S_ADS_NOMORE_COLUMNS )
{
   printf("%S ", pszColumn );
   FreeADsMem( pszColumn );
}

需求

最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	iads.h
Dll	Activeds.dll;Adsldp.dll;Adsldpc.dll

另請參閱

ADSI 錯誤碼

FreeADsMem

IDirectorySearch