IWMAddressAccess2::AddAccessEntryEx method (wmsdkidl.h)

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The AddAccessEntryEx method adds an entry to the IP address access list.

Syntax

HRESULT AddAccessEntryEx(
  [in] WM_AETYPE aeType,
  [in] BSTR      bstrAddress,
  [in] BSTR      bstrMask
);

Parameters

[in] aeType

A member of the WM_AETYPE enumeration specifying the specifying the access permissions (exclusion or inclusion).

[in] bstrAddress

Specifies an IP address as a BSTR, using standard "dot" notation. Both IPv4 and IPv6 addresses are supported. For example, 206.73.118.1 is an IPv4 address and fe80::201:3ff:fee8:5058 is an IPv6 address.

[in] bstrMask

Bit mask that defines which bits in the IP address are matched against. For example, if the IP address is 206.73.118.1 and the mask is 255.255.255.0, only the first 24 bits of the address are examined. Thus, any IP addresses in the range 206.73.118.XXX would match this entry.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Requirements

See also

IWMAddressAccess2 Interface