CreatePrivateNamespaceA 関数 (winbase.h)

プライベート名前空間を作成します。

構文

HANDLE CreatePrivateNamespaceA(
  [in, optional] LPSECURITY_ATTRIBUTES lpPrivateNamespaceAttributes,
  [in]           LPVOID                lpBoundaryDescriptor,
  [in]           LPCSTR                lpAliasPrefix
);

パラメーター

[in, optional] lpPrivateNamespaceAttributes

名前空間オブジェクトのセキュリティ属性を指定する SECURITY_ATTRIBUTES 構造体へのポインター。

[in] lpBoundaryDescriptor

名前空間を分離する方法を定義する記述子。 呼び出し元は、この境界内にある必要があります。 CreateBoundaryDescriptor 関数は、境界記述子を作成します。

[in] lpAliasPrefix

名前空間のプレフィックス。 この名前空間にオブジェクトを作成するには、オブジェクト名 プレフィックスとしてオブジェクト名\指定。

異なる境界を定義している限り、システムは同じ名前の複数のプライベート名前空間をサポートします。

戻り値

関数が成功すると、新しい名前空間へのハンドルが返されます。

関数が失敗した場合、戻り値は NULL。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

他のアプリケーションは、OpenPrivateNamespace 関数を使用して名前空間にアクセスできます。

名前空間を作成したアプリケーションは、ClosePrivateNamespace 関数を使用して、名前空間へのハンドルを閉じます。 作成プロセスが終了すると、ハンドルも閉じられます。 名前空間ハンドルが閉じられた後、OpenPrivateNamespace 呼び出しは失敗しますが、名前空間内のオブジェクトに対するすべての操作は成功します。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0600 以降として定義します。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winbase.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll

関連項目

ClosePrivateNamespace の

オブジェクト名前空間の

OpenPrivateNamespace