DocumentId.FindUrlsById Method (Microsoft.Office.DocumentManagement)

Switch View :

ScriptFree

DocumentId.FindUrlsById Method

Finds the URLs of a document and all of its versions with a specified Id.

Namespace: Microsoft.Office.DocumentManagement
Assembly: Microsoft.Office.DocumentManagement (in Microsoft.Office.DocumentManagement.dll)

Syntax

Visual Basic (Declaration)

Public Shared Function FindUrlsById ( _
	site As SPSite, _
	docId As String _
) As String()

Visual Basic (Usage)

Dim site As SPSite
Dim docId As String
Dim returnValue As String()

returnValue = DocumentId.FindUrlsById(site, _
	docId)

public static string[] FindUrlsById(
	SPSite site,
	string docId
)

Parameters

site: Type: Microsoft.SharePoint.SPSite
ID to search for.

docId: Type: System.String
SPSite object to search on.

Return Value

Type: System.String()
Array of strings that represents the URLs of all versions of the document found with the specified DocumentId value.

Exceptions

Exception	Condition
ArgumentNullException	The SPSite object value is set to Nothing.

Remarks

An array of strings representing the URLs of all the versions of the document found with the specified Id. Nothing and 0 length arrays mean no results were found.

Reference

DocumentId Class

DocumentId Members

Microsoft.Office.DocumentManagement Namespace

FindUrlById(SPSite, String, String)

Community Content

Kobi L

What does "Urls of all Versions" mean?

It can't mean version history, or else FindUrlById wouldn't work ( https://gist.github.com/601848 ) - it specifically expects one url, and opens the SPItem to find the version Url.
I have an issue with two documents with the same Document-ID (docx file and a pptx file), and not sure it's related. The default document-id is link also misbehaving.
Under what circumstances can FindUrlsById return more than a single item?