| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The get_State method retrieves the state of the denial.
Syntax
HRESULT get_State(
CADenialState* penState
);
Parameters
penState
[out] Pointer to a variable that receives a member of the CADenialState enumeration. The returned value is either Denied or Transient.
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
If the state is denied, the denial is currently in effect, and blocks the associated object (such as a request).
If the state is transient, the owning policy needs some information that is not yet available. For example, parental ratings are delivered in-band, as part of the program, so they are not available when the user first submits the tune request. A parental policy would impose a transient denial; then, once the rating information was available, it either would change the state or remove the denial.
See Also