Discuss this help topic in CBFS Forum

CallbackFileSystem.GetAccessDeniedProcess method

Filter:

Pascal    C++ (DLL/Lib)    C++ (VCL)    C++ (.NET)    C#    VB.NET    Java 

CallbackFileSystem     See also    

Overview

Returns information about the element in the "Access Denied" process list

Declaration

[Pascal]
    procedure GetAccessDeniedProcess( Index : integer; var ProcessName : TCBString; var ProcessId : LongWord; var IncludeChildren : boolean; var DesiredAccess : TCbFsDesiredAccess );
    type TCBString = {$ifdef UNICODE}UnicodeString{$else}WideString{$endif};

[C++ (DLL/Lib)]
    void GetAccessDeniedProcess( int Index, wchar_t* *ProcessName, unsigned long * ProcessId, bool * IncludeChildren, CbFsDesiredAccess *DesiredAccess );

[C++ (VCL)]
    void __fastcall GetAccessDeniedProcess( int Index, TCBString &ProcessName, unsigned long &ProcessId, bool &IncludeChildren, CbFsDesiredAccess &DesiredAccess );

[C++ (.NET)]
    void GetAccessDeniedProcess( int Index, String* &ProcessName, unsigned long &ProcessId, bool &IncludeChildren, CbFsDesiredAccess &DesiredAccess );

[C#]
    void GetAccessDeniedProcess( int Index, ref String ProcessName, ref UInt32 ProcessId, ref bool IncludeChildren, ref CbFsDesiredAccess DesiredAccess );

[VB.NET]
    Sub GetAccessDeniedProcess( ByVal Index As Integer, ByRef ProcessName As String, ByRef ProcessId As UInt32, ByRef IncludeChildren As Boolean, ByRef DesiredAccess As CbFsDesiredAccess )

[Java]
    public void getAccessDeniedProcess( int index, stringRef processName, longRef processId, boolRef includeChildren, longRef desiredAccess );

Parameters

  • Index - the index of the element in the list of processes.
  • ProcessName - the name of process executable file. Can be empty if the element was added using PID and not file name
  • ProcessId - the PID (process ID) of process. Can be 0 if the element was added using the name of the executable file.
  • IncludeChildren - specifies if access is allowed to children of the given process
  • DesiredAccess - specifies what kind of access (read, write, both) is forbidden with this rule

Values of CbFsDesiredAccess

Description

Use this method to get information about the element of the list of processes, which are forbidden from accessing the storage.

If ProcessName is empty and ProcessID is -1, this means that the rule applies to all processes.

NOTE: Enable process restrictions by setting ProcessRestrictionsEnabled to true before calling this method. This method may be called only after a successful call to MountMedia method.

[C++ (Lib)] Memory for ProcessName value is allocated internally in API (you don't need to allocate it when calling this method). Use free() operator to free the memory which was allocated by API for ProcessName value.

Call from...

This method may be called only from outside of callback / event handlers.

See also

ProcessRestrictionsEnabled     AddDeniedProcess     DeleteDeniedProcess     GetAccessDeniedProcessCount    

Discuss this help topic in CBFS Forum