Client Properties
.gif)
| Previous | Next |
Client Properties
Windows Portable Devices supports the following client properties.
| Property | VarType | Description |
| WPD_CLIENT_DESIRED_ACCESS | VT_UI4 | A value that specifies that the client requires unique access permissions (such as GENERIC_READ only). If this property is not set, WPD assumes GENERIC_READ | GENERIC_WRITE which is the recommended default. |
| WPD_CLIENT_MAJOR_VERSION | VT_UI4 | A number that specifies the major version of the client. |
| WPD_CLIENT_MINOR_VERSION | VT_UI4 | A number that specifies the minor version of the client. |
| WPD_CLIENT_NAME | VT_LPWSTR | A name string for the client application. |
| WPD_CLIENT_REVISION | VT_UI4 | A number that specifies the revision (or build number) of the client. |
| WPD_CLIENT_SECURITY_QUALITY_OF_SERVICE | VT_UI4 | A value that specifies the security quality of service for the connection to the driver. This relates to the Security Quality of Service flags for CreateFile.
For example, these flags allow or disallow a driver to impersonate the client. SECURITY_IDENTIFICATION is assumed if this value is not provided. Typically, applications should set this value to SECURITY_IMPERSONATION, since some drivers will require impersonation in order to function. However, applications running under strict security requirements with a known subset of devices may want to restrict the driver's ability to identify or impersonate the caller. Note that reducing the impersonation level to anything lower than SECURITY_IMPERSONATION may result in some drivers having reduced functionality. |
| WPD_CLIENT_SHARE_MODE | VT_UI4 | A value that specifies the share mode the client is requesting from the driver. The possible values are the same as for CreateFile (for example, FILE_SHARE_READ, FILE_SHARE_WRITE, and so on).
(FILE_SHARE_READ | FILE_SHARE_WRITE) is assumed if the client does not specify this parameter. This is the recommended default. However, in cases where a different share mode is required (for example, FILE_SHARE_READ to request read sharing only), this parameter is required. |
| WPD_CLIENT_WMDRM_APPLICATION_PRIVATE_KEY | VT_VECTOR_|VT_UI1 | A value that specifies the Windows Media DRM application private key of the client. |
| WPD_CLIENT_WMDRM_APPLICATION_CERTIFICATE | VT_VECTOR_|VT_UI1 | A value that specifies the Windows Media DRM certificate of the client. |
Requirements
Header: Defined in PortableDevice.h
See Also
| Previous | Next |