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 );
}

要件

関連項目

ADSI エラー コード

FreeADsMem

IDirectorySearch