IWiaDrvItem::GetItemName メソッド (wiamindr_lh.h)
IWiaDrvItem::GetItemName メソッドは、パス情報を含まない現在の IWiaDrvItem アイテム名を取得します。
構文
HRESULT GetItemName(
BSTR *__MIDL__IWiaDrvItem0003
);
パラメーター
__MIDL__IWiaDrvItem0003
pbstrItemName [out, optional]
項目名を含む文字列のアドレスを受け取るメモリの場所を指します。
戻り値
メソッドが成功すると、 pbstrItemName に項目の名前へのポインター (パス情報は含まれません) が格納され、 S_OKが返されます。 メモリ不足のためにメソッドが文字列の割り当てに失敗した場合は、 E_OUTOFMEMORYを返します。 パラメーター pbstrItemName が無効な場合、メソッドは E_INVALIDARGを返します。 別の理由でメソッドが失敗した場合は、標準の COM エラー コードが返されます。
注釈
使用可能なメモリが十分にある場合、 メソッドは、パス情報を除き、現在の項目の名前を含む文字列を割り当てます。 メソッドは pbstrItemName 内の文字列へのポインターを返します。 ミニドライバーは 、SysFreeString 関数を呼び出して、文字列で使用されるメモリの割り当てを解除する必要があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | wiamindr_lh.h (Wiamindr.h を含む) |