ファイル クラウド アプリケーション ポリシー要求を送信するための要求構造。 要求は、特定のファイルの各操作の強制レベルを含むアクションの一覧を返します。 アプリケーションが対応している場合、アクションの一覧には、各操作の強制レベルの None が含まれます。
構文
struct GetFileApplicationAccessRequest
{
_Field_z_ LPCWSTR filePath;
_Field_z_ LPCWSTR applicationName;
BOOLEAN* isRestrictedBrowserApp;
DWORD* numOfActions;
_Field_size_(*numOfActions) DlpAction* actions;
DlpSerializedBuffer policyInfo;
};
Members
filePath[IN]
ここで定義されている完全修飾 win32 ファイル パス。
applicationName[IN]
ファイルを処理するプロセスのイメージ名。 たとえば、notepad.exe、chrome.exe。
isRestrictedBrowserApp[OUT]
アプリケーションが、ファイルを開くのを制限されているブラウザーであるかどうかを示します。
numOfActions[IN/OUT]
呼び出し中、パラメーターは DlpAction 配列のサイズを保持します。 戻り値には、関連するアクションの数が含まれます。
アクション[OUT]
numOfActions フィールドによってサイズが定義されているDlpActionの事前に割り当てられた配列へのポインター。 呼び出しが成功すると、ファイルに適用する必要があるアクションの一覧が含まれます。
policyInfo[OUT]
強制アクションが発生したときにレポート API に渡す必要がある内部ポリシー情報を含む DlpSerializedBuffer へのポインター。 このバッファーは、 DlpReleaseBuffer を使用して解放する必要があります。
返品ポリシー
成功した場合、関数はS_OKを返します。 そうでない場合は、次のいずれかのエラー コードを返すことができます。
-
E_OUTOFMEMORY- アクション配列のサイズが十分な大きさではありません。 -
ACCESS_DENIED- ユーザーには、ファイル EA の読み取りアクセス許可がありません。 この場合、呼び出し元は正しいユーザー コンテキストを偽装し、関数呼び出しを再試行する必要があります。 それ以外の場合は FAILED HRESULT を返します。
注釈
DlpRequestId の RequestIdGetFileApplicationAccess に対応します。
この関数は複数のスレッドから呼び出すことができます。
このポリシーでは、未承認のアプリケーションとクラウド エグレス アプリケーションの 2 つのリストを定義します。 アプリケーションによってファイルが開かれたときに AccessByUnallowedApp アクションの種類を適用するかどうかを決定するには、許可されていないアプリケーションの一覧が使用されます。 アプリケーションが一覧にない場合は、適用されません。
クラウド エグレス リストは、 CloudAppEgress アクションを適用するときに使用されます。 アクションが Audit、 Warn 、または Blockに設定されていて、アプリケーションの種類が一覧に含まれている場合は、ブラウザーとして識別されます。 エンドポイント DLP に対応しているブラウザーのみがファイルを開くことが許可され、それ以外はすべて制限されます。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされている最小のクライアント | Windows 11 バージョン 24H2 (ビルド 26100) |
| DLL | EndpointDlp.dll |