WIN_TRUST_ACTDATA_CONTEXT_WITH_SUBJECT

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.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winbase.h.

See Also

WinTrust Overview, WinTrust Structures, GUID, WIN_TRUST_ACTDATA_SUBJECT_ONLY, WIN_TRUST_SUBJECT_FILE, WinVerifyTrust