WIN_TRUST_ACTDATA_CONTEXT_WITH_SUBJECT - Win32 Programmer's Reference (win32.hlp)

Quick Info

Windows NT
Yes
Win95
No
Win32s
No
Import Library

Header File
winbase.h
Unicode
No
Platform Notes
None

WIN_TRUST_ACTDATA_CONTEXT_WITH_SUBJECT

[New - Windows NT]

The WIN_TRUST_ACTDATA_CONTEXT_WITH_SUBJECT structure identifies the subject to be evaluated in some WinVerifyTrust verification operations. For example, Microsoft's Software Publisher Trust Provider uses this structure with some of its action identifiers.

typedef struct _WIN_TRUST_ACTDATA_CONTEXT_WITH_SUBJECT {

HANDLE hClientToken;

GUID * SubjectType;

WIN_TRUST_SUBJECT Subject;

} WIN_TRUST_ACTDATA_CONTEXT_WITH_SUBJECT, *LPWIN_TRUST_ACTDATA_CONTEXT_WITH_SUBJECT ;

Members
hClientToken

Handle to the access token of the calling process.SubjectType

Pointer to a GUID structure that identifies the type of subject that a trust provider must evaluate. The value of this member determines the type of data pointed to by the Subject member.

The WinTrust service is designed to work with trust providers and subject interface packages (SIPs) implemented by third parties. Each SIP provides its own unique set of subject type identifiers, and each trust provider specifies the set of subject types that it can evaluate for a specified action identifier. For information about the subject and action identifiers supported by a trust provider, see the documentation for that trust provider.

For example, for the WIN_SPUB_ACTION_PUBLISHED_SOFTWARE action, Microsoft's Software Publisher Trust Provider supports the following subject types.

Value

Description

WIN_TRUST_SUBJTYPE_PE_IMAGE

Microsoft Portable Executable image files.

WIN_TRUST_SUBJTYPE_JAVA_CLASS

Java class files.

WIN_TRUST_SUBJTYPE_CABINET

WIN_TRUST_SUBJTYPE_RAW_FILE

Subject

Pointer to a buffer that a trust provider uses to access the subject. The format of this data depends on the type of subject. For example, the subject types supported by the WIN_SPUB_ACTION_PUBLISHED_SOFTWARE action use a WIN_TRUST_SUBJECT_FILE structure that contains a handle or a path to the file to be evaluated.

Remarks
The WIN_TRUST_ACTDATA_CONTEXT_WITH_SUBJECT structure is one of the data structures defined in WINBASE.H for use with the ActionData parameter of the WinVerifyTrust function. Trust providers can use one of the predefined structures, or define their own.

See Also
GUID, WIN_TRUST_ACTDATA_SUBJECT_ONLY, WIN_TRUST_SUBJECT_FILE, WinVerifyTrust

More Online Helps

Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages

greatis just4fun network