ICompactServerUrlGroup::AddUrl method

Adds a URL suffix to the list of URLs in the URL group.

Syntax

HRESULT AddUrl(
  [in]                                                  LPCWSTR urlSuffix,
  [in]                                                  LPCWSTR sourceFilePath,
  [in]                                                  LPCWSTR sddlAccessCheck,
  [in]                                                  ULONG hashCount,
  [in, size_is(hashCount,20), length_is(hashCount,20)]  BYTE **certificateHashAccessCheck
);

Parameters

• urlSuffix [in]
  Specifies the URL suffix to be added. The URL suffix is appended to the URL prefix by calling the HttpAddUrlToUrlGroup function.

• sourceFilePath [in]
  Specifies the path of the source file.

• sddlAccessCheck [in]
  Specifies the SDDL used if Negotiate is the authentication method.

• hashCount [in]
  Reserved for future use. Must be set to 0.

• certificateHashAccessCheck [in]
  Reserved for future use. Must be set to NULL.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The request to add the URL suffix to the URL prefix will get routed to the longest registered URL prefix. For more information, see the longest match rule section in the UrlPrefix Strings topic.

If the url1/myUrl1/url.txt suffix is added to a URL group that has https://+:80/url1 as the defined prefix, clients can download from the following address: https://<IPAddress>/url1/myUrl1/url.txt.

When this method is called, the caller can specify the level of authorization required for the URL.

If the caller cannot access the file or source file that is specified in the sourceFilePath parameter, this API method will fail.

Requirements

See also

ICompactServerUrlGroup

Send comments about this topic to Microsoft

Build date: 11/12/2012