Win32 API 日本語リファレンス
ホーム › Media.WindowsMediaFormat › IWMCredentialCallback

IWMCredentialCallback

COM
📘 Microsoft Learn (日本語) · English
IID342e0eb7-e651-450c-975b-2ace2c90c48e継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMCredentialCallback インターフェイスは、リーダーオブジェクトがユーザーの資格情報を取得するために使用するコールバックインターフェイスです。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT AcquireCredentials(LPWSTR pwszRealm, LPWSTR pwszSite, LPWSTR pwszUser, DWORD cchUser, LPWSTR pwszPassword, DWORD cchPassword, HRESULT hrStatus, DWORD* pdwFlags)

AcquireCredentials メソッドは、ユーザーがリモートサイトにアクセスする権限を持っていることを確認するために、ユーザーの資格情報を取得します。

pwszRealmLPWSTRinレルムの名前を格納する、ワイド文字の null 終端文字列へのポインター。
pwszSiteLPWSTRinサイトの名前を格納する、ワイド文字の null 終端文字列へのポインター。サイトとは、リモートサーバーの名前です。
pwszUserLPWSTRoutユーザー名を格納するバッファーへのポインター。アプリケーションは、このバッファーにユーザー名をコピーする必要があります。このメソッドが最初に呼び出されたとき、バッファーは空です。メソッドが再度呼び出された場合(たとえば、ユーザーが資格情報を誤って入力した場合など)、バッファーには前回の呼び出しの名前が含まれていることがあります。
cchUserDWORDinpwszUser バッファーのサイズを、ワイド文字数で指定します。
pwszPasswordLPWSTRoutパスワードを格納するバッファーへのポインター。アプリケーションは、このバッファーにユーザーのパスワードをコピーする必要があります。
cchPasswordDWORDinpwszPassword バッファーのサイズを、ワイド文字数で指定します。
hrStatusHRESULTinHRESULT のリターンコードを指定します。
pdwFlagsDWORD*outWMT_CREDENTIAL_FLAGS 列挙型の 0 個以上のフラグをビットごとの OR で組み合わせた値を格納する DWORD へのポインター。入力時には、呼び出し元が該当するフラグを設定します。出力時には、アプリケーションは呼び出し元が設定したフラグをクリアし、必要に応じて追加のフラグを設定する必要があります。詳細については、WMT_CREDENTIAL_FLAGS を参照してください。

戻り値

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。

解説(Remarks)

このメソッドは、リモート URL への要求で認証が必要な場合に使用されます。

リーダーオブジェクトは、ユーザーのユーザー名とパスワードを取得するために、アプリケーションの AcquireCredentials メソッドを呼び出します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IWMCredentialCallback "{342E0EB7-E651-450C-975B-2ACE2C90C48E}"
#usecom global IWMCredentialCallback IID_IWMCredentialCallback "{}"
#comfunc global IWMCredentialCallback_AcquireCredentials  3 wstr,wstr,var,int,var,int,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。