PssWalkMarkerCreate function (processsnapshot.h)
Creates a walk marker.
Syntax
DWORD PssWalkMarkerCreate(
[in, optional] PSS_ALLOCATOR const *Allocator,
[out] HPSSWALK *WalkMarkerHandle
);
Parameters
[in, optional] Allocator
A structure that provides functions to allocate and free memory. If you provide the structure, PssWalkMarkerCreate uses the functions to allocate the internal walk marker structures. Otherwise it uses the default process heap. For more information, see PSS_ALLOCATOR.
[out] WalkMarkerHandle
A handle to the walk marker that this function creates.
Return value
This function returns ERROR_SUCCESS on success or the following error code.
Return code | Description |
---|---|
|
Could not allocate memory for the walk marker. |
All error codes are defined in winerror.h. Use FormatMessage with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a message for an error code.
Remarks
The walk marker maintains the state of a walk, and can be used to reposition or rewind the walk.
The Allocator structure that provides the custom functions should remain valid for the lifetime of the walk marker. The custom functions are called from PssWalkMarkerCreate, PssWalkMarkerFree and PssWalkSnapshot using the same thread that calls PssWalkMarkerCreate, PssWalkMarkerFree and PssWalkSnapshot. Therefore the custom functions need not be multi-threaded.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8.1 [desktop apps only] |
Minimum supported server | Windows Server 2012 R2 [desktop apps only] |
Target Platform | Windows |
Header | processsnapshot.h |
DLL | Kernel32.dll |