次の方法で共有

RemovePropA 関数 (winuser.h)

  • [アーティクル]

指定したウィンドウのプロパティ リストからエントリを削除します。 指定した文字列は、削除するエントリを識別します。

構文

HANDLE RemovePropA(
  [in] HWND   hWnd,
  [in] LPCSTR lpString
);

パラメーター

[in] hWnd

型: HWND

プロパティ リストを変更するウィンドウへのハンドル。

[in] lpString

型: LPCTSTR

null で終わる文字列、または文字列を識別するアトム。 このパラメーターが atom の場合は、GlobalAddAtom 関数を使用して作成されている必要があります。 16 ビット値である atom は、lpStringの下位ワード 配置する必要があります。高次ワードはゼロでなければなりません。

戻り値

型: HANDLE

戻り値は、指定されたデータを識別します。 指定したプロパティ リストにデータが見つからない場合、戻り値は NULL。

備考

戻り値は、SetPropに渡された hData 値です。これはアプリケーション定義の値です。 この関数は、データとウィンドウの間の関連付けを破棄するだけです。 必要に応じて、アプリケーションは、プロパティ リストから削除されたエントリに関連付けられているデータ ハンドルを解放する必要があります。 アプリケーションは、追加したプロパティのみを削除できます。 他のアプリケーションまたはシステム自体によって追加されたプロパティを削除することはできません。

RemoveProp 関数は、アプリケーションがハンドルに関連付けられているデータを解放できるように、文字列に関連付けられているデータ ハンドルを返します。

Windows Vista 以降では、RemoveProp は、ユーザー インターフェイス特権分離 (UIPI) の制限の対象となります。 プロセスは、整合性レベルが低いか等しいプロセスに属するウィンドウでのみ、この関数を呼び出すことができます。 UIPI がプロパティの変更をブロックすると、GetLastError 5返されます。

例

例については、「削除」を参照。

手記

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RemoveProp を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winuser.h (Windows.h を含む)
ライブラリ User32.lib
DLL User32.dll
API セットの ext-ms-win-ntuser-window-l1-1-0 (Windows 8 で導入)

関連項目

AddAtom を する

概念

GetProp を する

リファレンス

SetProp の

ウィンドウのプロパティ