Partager via

RspInitialize (Compact 7)

  • Article

3/12/2014

This function initializes a Resource Service Provider instance and must be called before calling any other Resource Service Provider function.

Syntax

RM_RESULT RspInitialize(
    __in_bcount(cbHostInfo) const RSP_HOST_INFO* pHostInfo,
    __in DWORD const cbHostInfo,
    __out_bcount(*pcbProviderInfo) RSP_PROVIDER_INFO* pProviderInfo,
    __inout DWORD* pcbProviderInfo
);

Parameters

  • [in] cbHostInfo
    [in] Number of bytes in the pHostInfo structure.

  • [in,out] pProviderInfo
    [in] Pointer to a storage area to place the output.

    [out] Pointer to an RSP_PROVIDER_INFO structure.

  • [in,out] pcbProviderInfo
    [in] Pointer to the number of bytes allocated to the pProviderInfo structure.

    [out] Pointer to the number of bytes actually returned by the call.

Return Value

The function returns the following values:

Value Description

RMRE_SUCCESS

The call succeeded.

RMRE_INSUFFICIENT_BUFFER

The pcbProviderInfo parameter indicates the size of the pProviderInfo parameter is too small to hold the structure. The output pcbProviderInfo parameter value contains the minimum size required.

RMRE_INVALID_VERSION

The version of the pHostInfo parameter is invalid.

RMRE_INVALID_PARAMETER

One of the input parameters is invalid.

RMRE_UNEXPECTED

An unexpected failure occurred.

Requirements

Header

rmnet.h,
rmrsp.h

Library

RspCellular.lib

See Also

Reference

Resource Manager Service Provider Functions
RSP_HOST_INFO
RSP_PROVIDER_INFO
Resource Manager Service Provider Reference