ITFormatControl::ReOrderCapabilities method

Article
03/22/2021

[ This method is not available for use in Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The RTC Client API provides similar functionality.]

The ReOrderCapabilities method sets a new order for format capabilities.

Syntax

HRESULT ReOrderCapabilities(
  [in] DWORD *pdwIndices,
  [in] BOOL  *pfEnabled,
  [in] BOOL  *pfPublicize,
  [in] DWORD dwNumIndices
);

Parameters

pdwIndices [in]: Index of the format being reordered.
pfEnabled [in]: Indicates whether the format should be enabled or disabled.
pfPublicize [in]: Indicates whether the format should be made available.
dwNumIndices [in]: New index number for the format.

Return value

This method can return one of these values.

Return code	Description
S_OK	Method succeeded.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

Remarks

The GetNumberOfCapabilities method must be called prior to using this method.

Requirements

Requirement	Value
TAPI version	Requires TAPI 3.1
Header	Ipmsp.h
Library	Uuid.lib
DLL	Tapi3.dll