次の方法で共有


IWiaDrvItem::GetFullItemName メソッド (wiamindr_lh.h)

IWiaDrvItem::GetFullItemName メソッドは、パス情報を含む項目のフル ネームを取得します。

構文

HRESULT GetFullItemName(
  BSTR *__MIDL__IWiaDrvItem0002
);

パラメーター

__MIDL__IWiaDrvItem0002

pbstrFullItemName [out, optional]

項目の完全な名前を含む文字列のアドレスを受け取るメモリの場所を指します。

戻り値

メソッドが成功した場合、pbstrFullItemName にパス情報を含む項目の完全な名前へのポインター 格納され、S_OKを返します。 メモリ不足のためにメソッドが文字列の割り当てに失敗した場合は、E_OUTOFMEMORYを返します。 pbstrFullItemName パラメーターが無効な場合、このメソッドは E_INVALIDARGを返します。 別の理由でメソッドが失敗した場合は、標準の COM エラー コードが返されます。

備考

使用可能なメモリが十分にある場合、このメソッドは、パス情報を含む現在の項目の完全な名前を含む文字列を割り当てます。 このメソッドは、pbstrFullItemName 内の文字列へのポインター返します。 ミニドライバーは、SysFreeString 関数を呼び出すことによって、文字列によって使用されるメモリの割り当てを解除する必要があります。

pbstrFullItemName で返される名前は、wiasCreateDrvItem ドライバー サービス ライブラリ関数によって項目が最初に作成されたときに、項目に関連付けられた名前です。

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー wiamindr_lh.h (Wiamindr.h を含む)

関連項目

IWiaDrvItem

wiasCreateDrvItem