CeGetDevMgmtPackageList (Windows Embedded CE 6.0)

1/6/2010

This function retrieves the record in a device management package database.

Syntax

HRESULT CeGetDevMgmtPackageList(
  PDMSINVRECORD pRecord,
  LPDWORD pdwEntryNumber,
  DWORD dwFilter
);

Parameters

• pRecord
  [in] Buffer to receive the records. If this parameter is NULL, *pdwEntryNumber returns the number of records that match the searching filter.

• pdwEntryNumber
  [in, out] Specifies the size of pRecord in sizeof(DMSINVRECORD). If the function succeeds, *pdwEntryNumber returns the number of records put in pRecord.

• dwFilter
  [in] Specifies the type of records to be retrieved. This can be a combination of one of the values shown in the following table, except for PACKAGE_SRCH_BY_ID.

  Value	Description
  PACKAGE_OPTIONAL	Indicates that the package is optional.
  PACKAGE_MANDATORY	Indicates that the package is mandatory.
  PACKAGE_DL_PENDING	Indicates that the download of the package is pending.
  PACKAGE_DL_FAIL	Indicates that the download of the package failed.
  PACKAGE_DL_SUCCESS	Indicates that the download of the package was successful
  PACKAGE_SRCH_BY_ID	Used to retrieve a record with a specific package identifier.
  PACKAGE_GET_ID_ONLY	Used to get only the package ID, instead of the entire record. In this case, the data type of pRecord becomes *DMSINVPKGID.

Return Value

Returns S_OK if the task is scheduled successfully. This function also supports the standard return value E_INVALIDARG.

Requirements

See Also

Reference

Device Management Client Functions
DMSINVRECORD

Concepts

API Access