IHttpUser::GetUserName メソッド

ユーザー名を返します。

構文

virtual PCWSTR GetUserName(  
   VOID  
) = 0;  

パラメーター

このメソッドは、パラメーターを受け取りません。

戻り値

ユーザー名を含む定数 null で終わる Unicode 文字列へのポインター。

解説

返される値は、認証の種類によって異なります。 認証の種類は 、GetAuthenticationType メソッドから返されます。

次の表は、関連付けられたユーザー名の値またはパターンを持つ認証の種類を示しています。

実装側の注意

IHttpUser実装者は、このデータを使用したメモリ管理を担当します。そのため、IHttpUser動的メモリ割り当てを使用する実装者は、不要になったときにポインターをPCWSTR解放または呼び出すdelete必要があります。

呼び出し元に関する注意事項

IHttpUser実装者は、このデータを使用したメモリ管理を担当します。そのため、クライアントは、IHttpUserこのデータが不要になった場合に、返されたPCWSTRポインターを解放したり、 を呼び出deleteしたりすることはできません。 さらに、クライアントは、このデータを ポインター const にキャストしたり、このポインターによって PCWSTR参照されるメモリの状態を変更したりしてはなりません。それ以外の場合は、アクセス違反がスローされるか、データが無効になります。

例

次のコード例では、応答ヘッダーと本文をクリアし、ユーザー情報を XML ドキュメントとしてクライアントに返す HTTP モジュールを作成する方法を示します。

上記のコードは、次のような応答ストリームに XML を書き込みます。

<?xml version="1.0" ?>  
<user userName="DOMAIN\user" />  

モジュールは RegisterModule 関数をエクスポートする必要があります。 この関数をエクスポートするには、プロジェクトのモジュール定義 (.def) ファイルを作成するか、スイッチを使用してモジュールを /EXPORT:RegisterModule コンパイルします。 詳細については、「 チュートリアル: ネイティブ コードを使用したRequest-Level HTTP モジュールの作成」を参照してください。

必要に応じて、各関数の呼び出し規約を __stdcall (/Gz) 明示的に宣言するのではなく、呼び出し規約を使用してコードをコンパイルできます。

要件

参照

IHttpUser インターフェイス
IHttpUser::GetPassword メソッド
IHttpUser::GetRemoteUserName メソッド