DeleteAppContainerProfile 関数 (userenv.h)

指定したユーザーごとのアプリごとのプロファイルを削除します。

メモ存在しないプロファイルを削除すると、成功が返されます。

構文

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

[in] pszAppContainerName

CreateAppContainerProfile 関数の呼び出しでプロファイルに指定された名前。この文字列の長さは最大 64 文字で、正規表現 "[-_" で記述されたパターンに収まります。 A-Za-z0-9]+"

この関数が成功すると、次のような標準の HRESULT コードが返されます。

リターンコード	説明
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	メソッドがアプリコンテナー内から呼び出された場合。
S_OK	プロファイルが正常に削除されました。
E_INVALIDARG	コンテナー名が NULL の場合、または指定した長さの制限を超えている場合。

最適な結果を得るには、 DeleteAppContainerProfile 関数を呼び出す前に、プロファイルストレージの場所にあるすべてのファイルハンドルを閉じます。それ以外の場合、この関数はプロファイルのストレージの場所を完全に削除できない場合があります。

この関数は、現在のユーザーのプロファイルを削除します。別のユーザーのプロファイルを削除するには、そのユーザーを偽装する必要があります。

関数が失敗した場合、プロファイルの状態は未定義になり、 DeleteAppContainerProfile をもう一度呼び出して操作を完了する必要があります。